home *** CD-ROM | disk | FTP | other *** search
/ Whiteline: delta / whiteline CD Series - delta.iso / tools / dfue / cat_utis / decat14 / readme < prev   
Text File  |  1995-11-25  |  19KB  |  398 lines
  1.  
  2.                   DECAT 1.4 - PGP Dekodierer für CAT
  3.                   ==================================
  4.  
  5. (c) Dietrich Feist 28.07.1995
  6.  
  7. ***** WICHTIG! - WICHTIG! - WICHTIG! - WICHTIG! - WICHTIG! *****
  8. *                                                              *
  9. * Gegenüber Version 1.3 hat sich der Aufbau der Kommandozeile  *
  10. * geändert! Auch Benutzer von DECAT 1.3 sollten also unbedingt *
  11. * den Punkt "Aufbau der Kommandozeile" aufmerksam lesen!       *
  12. *                                                              *
  13. ***** WICHTIG! - WICHTIG! - WICHTIG! - WICHTIG! - WICHTIG! *****
  14.  
  15. Dieses Programm ist Freeware! Es darf beliebig weitergegeben werden, solange
  16. dafür keinerlei Gebühren verlangt werden! Das Ablegen in Mailboxen ist
  17. ausdrücklich erwünscht! Näheres dazu am Schluß dieses Textes.
  18.  
  19. Das Programm DECAT dekodiert automatisch alle mit PGP kodierten
  20. ankommenden Nachrichten im Outfile. Es kann unter CAT als I/O-Filter für
  21. installiert werden und entschlüsselt so die Nachrichten, bevor der Inhalt
  22. des Outfiles in die Datenbasis eingefügt wird. Zusätzlich werden neue Keys
  23. (natürlich unsigniert) in den öffentlichen Schlüsselbund eingefügt.
  24.  
  25.  
  26. Dokumentation:
  27.  
  28. Dieser Text verdient diese Bezeichnung kaum, ist aber das einzige, was ich
  29. in dieser Hinsicht liefern kann. Falls jemand den Ehrgeiz verspürt, eine
  30. bessere Dokumentation zu schreiben, dann ist er/sie herzlich willkommen.
  31.  
  32.  
  33. Systemvoraussetzungen:
  34.  
  35.  - eine funktionsfähige Version von PGP muß bereits installiert sein.
  36.    Getestet wurde DECAT von mir mit den Versionen 2.3 und 2.6ui.
  37.  
  38.  - CAT ab Version 2.5 sollte installiert sein. Da das Programm als externer
  39.    I/O-Filter installiert wird, muß es sich dabei um eine registrierte
  40.    Version handeln.
  41.  
  42.  - Unter CAT sollte die Packerausgabe nicht umgelenkt werden, sonst kann
  43.    man sein Passwort nicht eingeben! Alternativ kann man auch die
  44.    Environment-Variable PGPPASS setzen, dann muß kein Passwort mehr
  45.    eingegeben werden. PGPPASS sollte aber nur dann verwendet werden, wenn
  46.    wirklich niemand außer Ihnen Zugang zu Ihrem Rechner hat!
  47.  
  48.  - DECAT wertet die Environment-Variable TMP aus. Alle temporären Dateien
  49.    werden in das Verzeichnis geschrieben, das in TMP übergeben wurde. Wird
  50.    die Variable nicht gesetzt, werden alle temporären Dateien in das
  51.    gleiche Verzeichnis geschrieben, in dem sich auch das Programm befindet.
  52.    Diese Variable wird auch von PGP unterstützt.
  53.  
  54.  - Prinzipiell funktioniert DECAT auch ohne CAT, da zwischen den beiden
  55.    Programmen keine direkte Kommunikation erfolgt. DECAT benötigt nur
  56.    das Outfile mit den kodierten Nachrichten und erzeugt daraus ein
  57.    Outfile mit entschlüsselten Nachrichten. Insofern sollte es mit jedem
  58.    Maustauschprogramm zusammenarbeiten, das eine Bearbeitung des Outfiles
  59.    durch externe Filterprogramme vor dem Einfügen erlaubt. Auch der Einsatz
  60.    innerhalb der Skriptdatei eines Terminalprogramms wäre im Prinzip
  61.    denkbar.
  62.  
  63. Installation:
  64.  
  65.  - Das Programm DECAT.TTP in ein beliebiges Verzeichnis auf der Festplatte
  66.    kopieren. Ist die Environment-Variable PGPPATH nicht auf den Pfad
  67.    gesetzt, in dem sich auch PGP.TTP befindet, dann muß DECAT in das
  68.    gleiche Verzeichnis wie PGP.TTP kopiert werden. In diesem Fall kann
  69.    die Environment-Variable PGPPATH entfallen.
  70.  
  71.  - CAT starten und im Menü unter Optionen -> Allgemein das Feld
  72.    "Packerausgabe umlenken" abschalten. Wird die Packerausgabe umgelenkt,
  73.    dann kann man sein Passwort nicht mehr eingeben. In diesem Fall muß
  74.    die Environment-Variable PGPPASS das Passwort enthalten (s. dazu die
  75.    Dokumentation von PGP).
  76.  
  77.  - Den Menüpunkt Optionen -> I/O-Filter anwählen. Es erscheint eine
  78.    Dialogbox, in der externe Filterprogramme installiert werden können. Wie
  79.    das geht, steht in der Dokumentation zu CAT. Die Optionen sollten
  80.    folgendermaßen eingestellt werden:
  81.  
  82.        1. Wofür: "für In-/Outfile" angewählt
  83.        2. für Outfile: angekreuzt
  84.        3. für Infile: nicht angekreuzt
  85.        4. aktiv: angekreuzt
  86.        5. Kommandozeile für Outfile eingeben. Der genaue Aufbau wird
  87.           weiter unten im Punkt "Aufbau der Kommandozeile" beschrieben.
  88.  
  89.  - Danach die neuen Einstellungen sichern. Das wars!
  90.  
  91.  
  92. Programmablauf:
  93.  
  94. DECAT erwartet als Parameter in der Kommandozeile Pfad und Dateiname
  95. des Outfiles. In CAT kann man diese leicht durch das Kürzel $I$O übergeben.
  96. Zusätzlich kann man verschiedene Optionen angeben, mit deren Hilfe sich der
  97. Ablauf von DECAT steuern läßt. Beispielsweise kann die Bildschirmausgabe
  98. in eine Datei umgelenkt oder angegeben werden, in welche Datei gefundene
  99. Keys exportiert werden sollen. Es besteht auch die Möglichkeit, einen
  100. Testmodus zu aktivieren oder DECAT am Programmende auf einen Tastendruck
  101. warten zu lassen.
  102.  
  103. Bei der Umleitung der Bildschirmausgabe ist zu beachten, daß die Ausgabe
  104. entweder in das Logfile oder auf den Bildschirm erfolgt, nicht sowohl als
  105. auch! Bei Verwendung eines Logfiles sollte das Passwort also mit Hilfe der
  106. Umgebungs-variable PGPPASS übergeben werden, da man die Aufforderung zur
  107. Eingabe des Passworts ja nicht auf dem Schirm sehen kann.
  108.  
  109. Beim Maustausch wird das Programm automatisch gestartet, nachdem das
  110. Outfile ausgepackt worden ist. Falls eine PGP-kodierte Nachricht gefunden
  111. wurde, wird man nach dem Passwort für den geheimen Schlüssel gefragt. Das
  112. Passwort wird während der Eingabe nicht angezeigt, bei Tippfehlern kann mit
  113. der Backspace-Taste korrigiert werden. Die Eingabe endet, sobald die
  114. Return-Taste betätigt wird. Enthält die Environment-Variable PGPPASS das
  115. korrekte Passwort, wird man nicht zur Eingabe aufgefordert.
  116.  
  117. Das eingegebene Passwort bleibt bis zum Programmende gespeichert, so daß
  118. weitere Nachrichten automatisch entschlüsselt werden können, ohne daß eine
  119. erneute Eingabe des Passworts nötig wäre. Bei Programmende werden sämtliche
  120. Speicherbereiche mit Nullen überschrieben, in denen das Passwort während des
  121. Programmablaufs gespeichert war. Auf diese Weise ist es nicht möglich, das
  122. Passwort nach Ende des Programms irgendwo im Speicher zu finden.
  123.  
  124. Von der Verwendung der Environment-Variable PGPPASS muß generell abgeraten
  125. werden, auch wenn es vielleicht sehr bequem erscheint. Wird diese Variable
  126. gesetzt, dann kann jeder, der Zugang zu Ihrem Rechner hat, Ihr Passwort
  127. lesen!
  128.  
  129.  
  130. Aufbau der Kommandozeile:
  131.  
  132.     DECAT <outfile> [-t] [-k] [-h] [-x=<keys>] [-l=<logfile>] [-b=<ext>]
  133.  
  134. Grundsätzlich muß bei DECAT immer der Name des zu bearbeitenden Outfiles
  135. als Parameter <outfile> angegeben werden. Das läßt sich unter CAT sehr
  136. leicht mit der Kombination $I$O realisieren. Die anderen Optionen in
  137. eckigen Klammern sind beliebig. Die Reihenfolge spielt keine Rolle, als
  138. <outfile> wird der erste Parameter verwendet, der nicht mit einem "-"
  139. beginnt.
  140.  
  141. Die Optionen im einzelnen bedeuten:
  142.  
  143.    -t: Testmodus aktivieren. Im Testmodus wird die bearbeitete Datei
  144.        nicht gelöscht und die Ausgabe wird in die Datei KLARTEXT.TXT
  145.        geschrieben. Außerdem wird PGP grundsätzlich im Modus mit der
  146.        größten Geschwätzigkeit aufgerufen und vor dem Aufruf das
  147.        übergebene Environment angezeigt.
  148.  
  149.    -k: Die ursprüngliche Datei <outfile> wird nach erfolgreicher
  150.        Bearbeitung nicht gelöscht. Wird diese Option nicht gesetzt, dann
  151.        wird sie gelöscht, sofern beim Entschlüsseln keine Fehler auf-
  152.        getreten sind.
  153.  
  154.    -h: DECAT wartet beim Programmende erst auf einen Tastendruck.
  155.  
  156.    -x=<keys>: Im Outfile gefundene Schlüssel werden nur in die Datei
  157.               <keys> exportiert. Aus dieser Datei kann sie der
  158.               Benutzer dann manuell mit Hilfe von PGP in seinen
  159.               Schlüsselbund einfügen, ein automatisches Einfügen
  160.               erfolgt dann nicht! Sollte die Datei <keys> bereits
  161.               existieren, werden neue Schlüssel einfach daran
  162.               angehängt. Wird diese Option nicht angegeben, dann
  163.               werden neue Keys zunächst in eine temporäre Datei
  164.               exportiert, die am Programmende automatisch eingefügt
  165.               wird.
  166.  
  167.    -l=<logfile>: Die Bildschirmausgabe des Programms wird in die Datei
  168.                  <logfile> umgeleitet. Gleichtzeitig wird die Option -h
  169.                  deaktiviert.
  170.  
  171.    -b=<ext>: Dateinamenserweiterung der Sicherheitskopie, die Standard-
  172.              vorgabe ist "bak". Würde z.B. die Option -b=dup gewählt,
  173.              dann würde die ursprüngliche Version der Datei <outfile>
  174.              die Endung "dup" erhalten, also z.B. outfile.txt -->
  175.              outfile.dup. Wird diese Option nicht angegeben, wird die
  176.              Standardendung "bak" verwendet. In jedem Fall würde diese
  177.              Datei am Ende des Programms gelöscht, sofern keine Fehler
  178.              beim Entschlüsseln auftreten und die Option -k nicht
  179.              aktiviert wurde.
  180.  
  181. Alle Optionen müssen einzeln angegeben werden! Kombinationen aus mehreren
  182. wie etwa -kht funktionieren (noch) nicht.
  183.  
  184. Beispiele für Kommandozeilen und was sie bewirken:
  185.  
  186. $I$O -h               : DECAT erhält von CAT den Pfad und Namen des
  187.                         Outfiles und wartet am Programmende auf einen
  188.                         Tastendruck
  189.  
  190. -k outfile.txt -b=$$$ : DECAT entschlüsselt die Datei "outfile.txt" und
  191.                         legt eine Sicherheitskopie mit Namen "outfile.$$$"
  192.                         an. Diese Kopie wird in keinem Fall gelöscht, auch
  193.                         wenn keine Fehler beim Entschlüsseln aufgetreten
  194.                         sind.
  195.  
  196. $I$O -l=decat.log -t  : DECAT startet im Testmodus und bearbeitet die
  197.                         Datei, deren Namen ihm von CAT mitgeteilt wird.
  198.                         Die Bidlschirmausgabe wird in die Datei decat.log
  199.                         umgeleitet.
  200.  
  201.  
  202. Bekannte Fehler:
  203.  
  204.  - DECAT ist momentan nicht in der Lage, kodierte Nachrichten zu
  205.    entschlüsseln, die vor dem Versand gesplittet wurden. In so einem Fall
  206.    wird unter Umständen kein korrektes Outfile erzeugt.
  207.  
  208.  - Verwendet man DECAT unter EASE, gibt es eine Menge Probleme. Die
  209.    meisten dieser Probleme liegen aber an EASE und nicht an DECAT! Da ich
  210.    selbst EASE nicht besitze, ist die Korrektur dieser Probleme für
  211.    mich leider etwas schwierig. Mit THING scheint es ähnliche Probleme
  212.    zu geben.
  213.  
  214.  - Bei einigen Konfigurationen kann man bei der Angabe des Logfiles keinen
  215.    Pfad mit angeben. Ich konnte das Problem bisher nicht ausfindig machen,
  216.    weil es bei mir unter TOS 1.04 und Gemini einwandfrei funktioniert.
  217.  
  218.  
  219. Danksagungen:
  220.  
  221. Ich danke den Benutzern von DECAT für ihre zahlreichen Tips und
  222. Fehlermeldungen. Außerdem möchte ich Phil Zimmermann und allen anderen
  223. danken, die an der Entwicklung von PGP beteiligt waren bzw. sind.
  224.  
  225.  
  226. Entwicklungsgeschichtliches:
  227.  
  228. Version 1.0 beta
  229. ================
  230.  
  231. Diese Version lief offenbar nur auf meinem System gut. War PGPPATH nicht
  232. gesetzt, stürzte sie gnadenlos ab. Selbst wenn sie gesetzt war, war DECAT
  233. etwas wählerisch, was den übergebenen Pfad anging. Er durfte als letztes
  234. Zeichen keinen Backslash enthalten, wie es ja eigentlich die korrekte Form
  235. eines Pfades tun sollte. Diese Version wurde nur an die Betatester
  236. verteilt.
  237.  
  238. Version 1.1 beta
  239. ================
  240.  
  241. Hier wurden einige Fehler korrigiert. DECAT stürzt jetzt nicht mehr ab,
  242. wenn PGPPATH nicht gesetzt ist. Es ist jetzt auch egal, ob der Pfad einen
  243. Backslash als letztes Zeichen enthält oder nicht. Außerdem werden jetzt
  244. zusätzlich die Environment-Variablen TMP und PGPPASS unterstützt. In
  245. PGPPASS kann das Passwort gesetzt werden, so daß das Programm ganz ohne
  246. Benutzereingaben laufen kann. In TMP wird der Pfad übergeben, in den alle
  247. temporären Dateien geschrieben werden. Diese Version wurde nicht
  248. veröffentlicht, sondern sofort von Version 1.2 beta abgelöst.
  249.  
  250. Version 1.2 beta
  251. ================
  252.  
  253. Da ich nach Fertigstellung von Version 1.1 beta offenbar zu viel Zeit
  254. hatte, habe ich gleich noch eine Routine eingebaut, die automatisch
  255. neue Keys im Outfile erkennt und diese (natürlich ohne Echtheitszertifikat)
  256. in den öffentlichen Schlüsselbund einfügt. Hinter dem eingefügten Key wird
  257. eine entsprechende Nachricht in das neue Outfile eingefügt. Neue Keys, die
  258. innerhalb einer verschlüsselten Nachricht stehen, werden auf diese Weise
  259. nicht eingefügt! Diese Version wurde veröffentlicht, nachdem die
  260. Betatester keine größeren Mängel mehr gefunden haben.
  261.  
  262. Version 1.21
  263. ============
  264.  
  265. Die erste Version ohne den Zusatz "beta". Einige kleinere Bugs wurden
  266. beseitigt. Dazu zählte z.B. die fehlerhafte Anzeige von Namen beim
  267. Einfügen neuer Keys aus Info-Dateien. Auch die Auswertung der Fehler-
  268. meldungen von PGP wurde verbessert. So werden jetzt nur noch solche
  269. Nachrichten als dekodiert markiert, die wirklich von PGP fehlerlos
  270. entschlüsselt werden konnten. Bei neu eingefügten Keys werden jetzt
  271. Datum und Uhrzeit des Einfügens mit eingetragen. Außerdem kann die
  272. Ausgabe jetzt in eine Datei umgelenkt werden, deren Name als zweiter
  273. Parameter in der Kommandozeile übergeben wird.
  274.  
  275.  
  276. Version 1.3
  277. ===========
  278.  
  279. Nach etwas längerer Pause die erste Version, in der ich einige der vielen
  280. Anregungen und Wünsche der DECAT-Benutzer berücksichtigen konnte. DECAT
  281. unterstützt jetzt den PMCRYPT-Standard, wie er von Crosspoint und Enkat
  282. verwendet wird. Damit kann bei einer kodierten Nachricht auch der Betreff
  283. verschlüsselt übertragen werden.
  284.  
  285. Außerdem wird jetzt neben der vom aufrufenden Programm übergebenen
  286. Umgebung auch das Shell-Environment nach den Variablen TMP, TZ, PGPPATH
  287. und PGPPASS durchsucht. Damit sollte ein Teil der Probleme mit EASE der
  288. Vergangenheit angehören. Vielen Dank an Johannes Link für den Tip!
  289.  
  290. Die bisher übliche Einrahmung des entschlüsselten Textes in "----- begin
  291. decrypted pgp message -----" bzw. "----- end decrypted pgp message -----"
  292. ist jetzt weggefallen. Stattdessen gibt es jetzt nur noch eine kurze
  293. Meldung mit Datum und Uhrzeit am Ende der Mail. Der Nachteil ist, daß man
  294. jetzt in Nachrichten, bei denen nur ein Teil kodiert war (benutzt das
  295. jemand?) nicht mehr sehen kan, welcher Teil das war. Der große Vorteil
  296. ist aber, daß jetzt auch gruppenübergreifende Kommentare in kodierten
  297. Mails funktionieren können.
  298.  
  299.  
  300. Version 1.4
  301. ===========
  302.  
  303. Die Fehlerbehandlung wurde erheblich verbessert. Deshalb kann jetzt im
  304. Normalfall bei fehlerfreier Entschlüsselung das ursprüngliche Outfile
  305. gelöscht werden. Wem dies nicht gefällt, der kann das mit der Option
  306. -k verhindern. Überhaupt sind einige Dinge dazugekommen: endlich werden
  307. Keys in verschlüsselten Mails erkannt, statt automatischer Einsortierung
  308. können neue Keys auch in eine Datei exportiert und danach manuell 
  309. einsortiert werden, die Namenserweiterung der Sicherheitskopie ist jetzt
  310. frei wählbar und wenn es sein muß, wartet DECAT am Programmende auch
  311. auf einen Tastendruck. Da mich berufliche Gründe dazu zwingen, für mehrere
  312. Jahre in die Schweiz zu gehen, wird das vermutlich die letzte Version sein,
  313. an der ich beteiligt bin (von ein paar Bugfixes vielleicht mal abgesehen).
  314.  
  315. Ausblicke:
  316.  
  317.  - Spätere Versionen von DECAT sollen mit gesplitteten Mails umgehen
  318.    können.
  319.  
  320.  - Die Unterstützung von Multi-Tasking-Betriebssystemen soll weiter
  321.    verbessert werden.
  322.  
  323.  
  324. Nutzungsbedingungen:
  325.  
  326. DECAT ist Freeware! Jeder darf das Programm kostenlos und ohne weitere
  327. Verpflichtungen mir gegenüber für einen unbegrenzten Zeitraum verwenden
  328. und es außerdem beliebig kostenlos weitergeben. Die einzigen Bedingungen
  329. sind, daß er/sie sich nicht daran bereichert und keinerlei Veränderungen
  330. am Programm oder an der Dokumentation vornimmt. Alle Rechte, insbesondere
  331. die Rechte an den Sourcekodes verbleiben bei mir!
  332.  
  333. Besonders erwünscht ist die Weiterverbreitung über Mailboxen oder
  334. FTP-Server. Der Vertrieb über PD-Versender ist nur gestattet, wenn diese
  335. nicht mehr als die ihnen entstandenen Unkosten für das Kopieren verlangen.
  336. Im Zweifelsfall ist vorher mein Einverständnis einzuholen!
  337.  
  338. Bei der Weitergabe des Programms müssen alle Dateien des Archivs
  339. unverändert und zusammen weitergegeben werden. Dieser Text muß das
  340. Programm immer begleiten! Das Packen aller Dateien mit einem anderen
  341. Packer ist natürlich erlaubt.
  342.  
  343.  
  344. Anerkennung:
  345.  
  346. Wer seine Dankbarkeit für meine Arbeit nicht zügeln kann und mir unbedingt
  347. was Gutes tun will, der hat mehrere Möglichkeiten. Das ist aber keine
  348. Bedingung, sondern geschieht völlig freiwillig!
  349.  
  350. 1. Das Programm (auf seine Kosten) in beliebig vielen Mailboxen/FTP-Servern
  351.    uploaden.
  352.  
  353. 2. Mir eine Ansichtskarte aus dem nächsten Urlaub oder seiner Heimat
  354.    schicken. Bitte darauf deutlich vermerken, daß er/sie ein zufriedener
  355.    DECAT-User ist, sonst rätsele ich wochenlang, wer er/sie sein könnte.
  356.  
  357. 3. Bei einem beliebigen Mausstammtisch meine Rechnung bezahlen.
  358.  
  359. 4. Mir nach eigenem Ermessen eine Spende auf mein Konto Nr. 3290 34 750
  360.    bei der Postbank Karlsruhe, BLZ: 660 100 75, zukommen lassen.
  361.  
  362. 5. Einen großzügigen Geldbetrag zugunsten des Phil Zimmermann defense
  363.    funds spenden. Mit diesem Fond wird Phil Zimmermann finanziell
  364.    unterstützt, damit er seine Anwaltskosten in den wegen PGP
  365.    anstehenden Gerichtsverfahren bezahlen kann. Verschiedene amerikanische
  366.    Regierungsstellen (vor allem die Zollbehörde) haben ihn nach der
  367.    Veröffentlichung von PGP mit Klagen überhäuft, um eine weitere
  368.    Verbreitung von PGP zu verhindern.
  369.  
  370.  
  371. Der Autor:
  372.  
  373. Ich bin derzeit 28 Jahre alt und von Beruf Diplomphysiker. Da ich in
  374. Kürze meine Zelte in Deutschland abbrechen und für 3-4 Jahre in die
  375. Schweiz ziehen werde, sollten alle Anfragen bzgl. DECAT an die Adresse
  376. meiner Eltern gehen:
  377.  
  378.        Dietrich Feist
  379.        Trajanstraße 21 a
  380.        D-68526 Ladenburg
  381.  
  382.        EMail: Dietrich Feist @ HD (MausNet)
  383.  
  384. Anfragen, Kritik und Anregungen zu DECAT beantworte ich grundsätzlich nur
  385. per EMail! PMs an diese Adresse werde ich ab August 1995 wohl nur noch
  386. etwa einmal pro Monat lesen. Deshalb bitte etwas Geduld!
  387.  
  388.  
  389. Haftungsausschluß:
  390.  
  391.    Ich übernehme keinerlei Verantwortung oder Haftung für irgendwelche
  392.    Schäden, die durch den Gebrauch von DECAT entstehen! Die Installation
  393.    und Anwendung erfolgen auf eigenes Risiko! Ich weise ausdrücklich darauf
  394.    hin, daß es keine fehlerfreie Software gibt und DECAT somit unter
  395.    Umständen auch Fehler enthält, die zu Datenverlusten führen können.
  396.    Wer in so einem Fall kein entsprechendes Backup besitzt, ist selbst
  397.    schuld!
  398.